home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / util / wb / spriteclock1_1.lha / SpriteClock.doc < prev   
Text File  |  1994-02-08  |  4KB  |  113 lines
  1. SpriteClock V1.1     Release date:  09-Jan-93
  2.  
  3. ******************************************************************************
  4.  
  5. DISCLAIMER:
  6.    I don't feel responsible for any loss of data or damages to software or
  7.    hardware that may result directly or indirectly from the use of this
  8.    program. Use at YOUR OWN RISK!
  9.  
  10. ******************************************************************************
  11.  
  12. Distribution:
  13.    This program is freely distributable provided that (1) all files are
  14.    included in the distribution in their original, unchanged state
  15.    (SpriteClock, SpriteClock.info, SpriteClock.doc, Source)
  16.    and (2) it may not distributed as part of a commercial package.
  17.    Note that you may of course change the program, but if you redistribute
  18.    it: always include the original files unmodified!
  19.  
  20. ******************************************************************************
  21.  
  22. Purpose: Display the current system time using a sprite
  23.  
  24. ******************************************************************************
  25.  
  26. Usage:
  27.    recognized CLI Parameters / ToolTypes:
  28.        X=xx
  29.        Y=xx
  30.        SPRITE=xx
  31.        DRAWING_COLOR=xx
  32.        BACKGROUND_COLOR=xx
  33.        SELECTED_DRAWING_COLOR=xx
  34.        SELECTED_BACKGROUND_COLOR=xx
  35.        PRIORITY=xx
  36.  
  37. X:
  38. Y:                         Initial clock coordinates. These coordinates are
  39.                            HIRES-INTERLACED coordinates.
  40.                            Default is 0, 0.
  41.  
  42. SPRITE:                    The sprite to use. Note that sprite 0 is used for
  43.                            the mousepointer. If SPRITE=-1, the next available
  44.                            sprite will be used, which is usually sprite 1.
  45.                            Sprite 1 uses the same colors as the mousepointer.
  46.                            Defaults to 1.
  47.  
  48. DRAWING_COLOR:
  49. BACKGROUND_COLOR:          Normal drawing colors for the time and the "menu".
  50.                            There are 4 colors; color 0 is transparent.
  51.                            Defaults are 3 and 0.
  52.  
  53. SELECTED_DRAWING_COLOR:
  54. SELECTED_BACKGROUND_COLOR: Drawing colors for the "selected" state of the
  55.                            menu item.
  56.                            Defaults are 1 and 0.
  57.  
  58. PRIORITY:                  The priority of the input handler.
  59.                            Defaults to 70.
  60.  
  61. The clock sprite can be moved around just like a window: move the mouse
  62. over the clock display, press the left mouse button and move the display
  63. around. Pressing the right mouse button will give you a "menu" which
  64. lets you quit the program. Your may also send a CTRL-C signal to
  65. the clock process to make it quit.
  66.  
  67. The clock is a 12-hour clock, but it does not tell you whether it's "am" or
  68. "pm". I'm sorry for that, but a sprite is only 16 pixel wide, so I just
  69. didn't have room for a 24-hour clock.
  70.  
  71. NOTE:
  72.    - Most, if not all, mouseblankers turn off ALL sprites, not just the
  73.      mousepointer. That means that your mouseblanker will probably blank
  74.      the clock as well.
  75.    - If you set the system time back to an earlier time, the clock won't
  76.      pick up the change. It will just stop until the previous time and date
  77.      has been reached again. Setting the system time back is a bad habit
  78.      anyway, because it will also confuse utilities such as MAKE.
  79.    - If the display mode changes (e.g. from PAL to NTSC), the sprite may
  80.      be invisible. It gets repositioned every full minute.
  81.    - The sprite may be offscreen (e.g. if you have a fully overscanned
  82.      workbench with the clock positioned at the right edge, and you open
  83.      another screen which is not overscanned, you won't see the sprite).
  84.      In that case, move the screen around.
  85.  
  86. ******************************************************************************
  87.  
  88. System requirement:
  89.    Any Amiga running Kickstart V37 (2.04) or later (hopefully)
  90.  
  91. ******************************************************************************
  92.  
  93. Send bug reports, comments, congratulations, presents, money etc. to
  94.  
  95.      Christian Stieber
  96.      Konradstraße 41
  97.      D-85055 Ingolstadt
  98.      (Germany)
  99.  
  100. Currently, I'm a student and may be reached at:
  101.      Christian Stieber
  102.      Seitzstraße 6, Zi. 306
  103.      D-80538 München
  104.      (Germany)
  105.  
  106. EMail: stieber@informatik.tu-muenchen.de
  107.  
  108. ******************************************************************************
  109.  
  110. History:
  111.    V1.0  01-Jul-92  First public release
  112.    V1.1  09-Jan-93  Major changes I forgot about :(
  113.